simplify gather guidance for agents - #283
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Category: improvement
User Impact: Agents receive shorter, direct task guidance from
ghost gatherwithout losing package diagnostics available to integrations.Problem: Gather Markdown exposed Ghost's implementation state, including cover status, selection contracts, numbering, and support telemetry. That consumed context without changing the agent's next action.
Solution: Compile default Markdown into a task, always-present guidance, an explicit uncovered-decision policy, and a bulleted list of applicable IDs. Keep complete cover, contract, coverage, kind-purpose, and payload metadata in JSON, and make context-control evaluate the literal Markdown agents receive.
Validation:
pnpm run quality:all: passedpnpm check, format, andpnpm test: passedpnpm run quality:all: passedChangeset: added as a minor change because default gather output and task requirements change.
ghost Review:
ghost review --package packages/vessel-light/.ghost --base origin/main: advisory packet generated; changed files have no matching Vessel material locators and the offered visual median check does not apply.File changes
.changeset/simplify-gather-markdown.mdRecords the user-visible gather output change.
README.md,packages/ghost/README.mdShow the required task argument for Markdown gathers.
packages/ghost/src/commands/gather-command.tsRenders task guidance directly, requires an ask for Markdown, removes implementation telemetry and numbering, and retains JSON diagnostics.
packages/ghost/src/commands/command-discovery.tsUpdates compact help to show the required ask.
packages/ghost/src/init-payloads/skeleton/brand.md,packages/ghost/src/init-payloads/skeleton/glossary.mdGive starter packages direct fallback and selection language.
packages/ghost/src/scan/package-lint.tsWarns when always-present guidance lacks an
If no guidance appliespolicy.packages/ghost/src/skill-bundle/**Aligns making, grounding, schema, and audit instructions with the compiled Markdown and diagnostic JSON split.
packages/ghost/test/cli.test.tsCovers the simplified Markdown, required ask, fallback policy, and retained JSON behavior.
packages/context-control/**Feeds literal gather Markdown into selection trials instead of reconstructing a richer prompt from JSON.
packages/steering-control/lib/arms.mjsNames the injected section as task guidance rather than a Ghost menu.
packages/vessel-light/.ghost/index.mdAdds Vessel's package-specific uncovered-decision policy while preserving its one-screen budget.
Screenshots/Demos: N/A; this changes CLI and agent context output.